# 肌色分析タスクのステータスを確認します。

Endpoint: GET /s2s/v2.0/task/skin-tone-analysis/{task_id}
Security: BearerAuthenticationV2

## Security:

  - `BearerAuthenticationV2` (unknown)
    http bearer

## Path parameters:

  - `task_id` (string, required)
    確認するタスクの ID

## Response 200:

  - `200` (unknown)
    タスクステータスの確認に成功しました

## Response 200 fields (application/json):

  - `status` (integer)
    レスポンスステータス
    Example: 200

  - `data` (object)

  - `data.task_status` (string)
    このタスクのステータス
    Enum: "running", "success", "error"

  - `data.error` (string)
    エラー：
- `error_exceed_max_image_size`  - 入力画像サイズが最大制限を超えています
- `exceed_max_filesize` - 入力ファイルサイズが最大制限を超えています
- `invalid_parameter` - 無効なパラメータ値
- `error_download_image` - ソース画像のダウンロードエラー
- `error_download_mask` - マスク画像のダウンロードエラー
- `error_decode_image` - ソース画像のデコードエラー
- `error_decode_mask` - マスク画像のデコードエラー
- `error_nsfw_content_detected` - ソース画像で NSFW コンテンツが検出されました
- `error_no_face` - ソース画像で顔が検出されませんでした
- `error_pose` - ソース画像でポーズの検出に失敗しました
- `error_face_parsing` - ソース画像での顔セグメンテーションに失敗しました
- `error_inference` - 推論パイプラインエラー
- `exceed_nsfw_retry_limits` - NSFW 画像の生成を避けるための再試行制限を超えました
- `error_upload` - 結果画像のアップロードエラー
- `unknown_internal_error` - その他
    Enum: "error_exceed_max_image_size", "exceed_max_filesize", "invalid_parameter", "error_download_image", "error_download_mask", "error_decode_image", "error_decode_mask", "error_nsfw_content_detected", "error_no_face", "error_pose", "error_face_parsing", "error_inference", "exceed_nsfw_retry_limits", "error_upload", "unknown_internal_error"

  - `data.error_message` (string)
    エラーの詳細説明

  - `data.results` (object)

  - `data.results.face_quality` (object)

  - `data.results.face_quality.has_face` (boolean)
    Example: true

  - `data.results.face_quality.area` (string)
    Example: good

  - `data.results.face_quality.frontal` (string)
    Example: good

  - `data.results.face_quality.lighting` (string)
    Example: good

  - `data.results.face_quality.faceangle` (string)
    Example: good

  - `data.results.color` (object)

  - `data.results.color.eye_color` (string)
    目の色の hex 値
    Example: #293F9B

  - `data.results.color.eye_color_name` (string)
    Enum: "Amber", "Brown", "Green", "Blue", "Gray", "Other"

  - `data.results.color.lip_color` (string)
    唇の色の hex 値
    Example: #D23245

  - `data.results.color.eyebrow_color` (string)
    眉毛の色の hex 値
    Example: #5B2B31

  - `data.results.color.skin_color` (string)
    肌の色の hex コード
    Example: #b9947c

  - `data.results.color.hair_color` (string)
    Enum: "#a0a0a0", "#722626", "#000000", "#FAF0BE", "#42280E", "#808080", "#B56637"

  - `data.results.color.hair_color_name` (string)
    Enum: "Auburn", "Black", "Blonde", "Brown", "Grey/White", "Red"

## Response 400:

  - `400` (unknown)
    無効なタスク ID

## Response 400 fields (application/json):

  - `status` (integer)
    レスポンスステータス
    Example: 400

  - `error` (string)
    Example: Invalid task ID

## Response 401:

  - `401` (unknown)
    無効または欠落している API キー

## Response 401 fields (application/json):

  - `status` (integer)
    レスポンスステータス
    Example: 401

  - `error` (string)
    Example: Invalid API key

## Response 500:

  - `500` (unknown)
    タスク実行タイムアウト

## Response 500 fields (application/json):

  - `status` (integer)
    レスポンスステータス
    Example: 500

  - `error` (string)
    Example: Task execution timed out